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(54) Method and system for creating web-quality online documentation from the same source file 
as printed documentation 



(57) A method and system for creating documenta- 
tion in a first format from a source file in a second for- 
mat, where the source file has documentation text 
tagged with element tags, and where the second format 
source file conforms to second format element definition 
document definitions in a second format element defini- 
tion document, the method and system include: creating 
a first format element definition document having first 
format element definition document definitions by deriv- 
ing the first format element definition document from the 
second format element definition document and adding 
first format formatting definitions (100); creating a first 
format template having first format template definitions 
by importing the first format element definition docu- 
ment definitions and adding first format styles (102); 
and creating a first format source file having documen- 
tation text tagged with element tags by importing the 
first format template into the second format source file 
(104). 
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Description 

Field of the Invention 

[0001] This invention pertains to the field of online processing, and more specifically to a method and system for 
creating online documentation from.an existing source file used for print documentation. 

Background of the Invention 

[00021 This invention originates from a need for an efficient way to produce web-quality online documentation given 
an existing print source file comprising print documentation. In recent years, there has been an increasing des,re for 
pnoau^d users to have access to product documentation in different formats. In addition to hard copy documenta- 
0^ also esire online documentation. One of the challenges in creating online documentation lies .n creat.ng 
online documentation that has features which users usually associate with web viewing, such as ease of v ew ng nav- 
igation buttons, links, and online formatting. This task can be cumbersome when d,fferent end ^ userS | have H ^ e p ^ 
requirements for their documentation. Without the use of a simple conversion process, creat,ng onhne documentation 
an often bl time-consuming and costly, particularly where different versions ° f *^^^ 
[00031 One solution has been to create online documentation by creating a Portable Document Format file (a spec 
Ltion for electronic documents developed by Adobe Systems. Inc.) from an existing ^^^^^ 
umentation data. Any fully formatted document (i.e. source file) created on a Windows. Macintosh MS-DOS ^ UNIX 
platform can be converted into a Portable Document Format (PDF) file using Adobe Acrobat®. Acrobat® enab es PDF 
fi es to be viewed on different platforms using the Adobe Acrobat® family of servers and readers. 
bles users to send documents that contain distinctive typefaces, color, graphics, and photogra PteeMron ca ly to 
recipients regardless of the application used to create the originals. The advantage of using Acrobat® is that aknos 
Z type of document can be converted to a PDF file, and its reader software (Acrobat® Reader) .s freeware so that 
rinmments can be distributed to a greater number of users. 

?000 4 7 pTobtem with this sottion is that online documentation created from a source file appears exaction the 
monitor as pages that are printed from the source file. In other words, the fonts that are used for the hard I copy ^docu- 
mentation are the same fonts that appear in the online documentation, which are too small for online vew.ng. This often 

r u !ts™ 

Karku , language (HTML), a markup language used for documents on the Wor.d Wide Web This solution a lows 
a print oume file to be converted into an online format suitable for online viewing (i.e., readabte fonts, navigabon b* 
^ns. etc.). Because this solution largely involves mapping paragraph and character tags to predefined HTML tags, it .s 
nnt an efficient solution because it is very time-consuming. 

[00061 Aneed exists, therefore, for a method and system for creating online documentation from an existing print 
source file that can be easily converted into an online viewable format, and that results in documentation having a web- 
quality look and feel. 

Summar y of the Invention 

[0007] This invention is, in general, directed to method and system for creating web-quality online documentation 
frnm the same source files used for print documentation. , 
0008 T~ invention may comprise a method for creating documentation in a first- format — - 
a second format, wherein the source file in the second format comprises documentation text tagged w.th element^ tegs 
and element definitions, the source file conforming to second format EDD definitions corresponding to a second format 
^D^ttK^^ng: creating a first format EDD comprising first format EDD definitions by deriving the first for- 
mat EDD deTnitions from the second format EDD definitions, and modifying the first format EDD demons to comprise 

mat template definitions comprising first format EDD definitions and first format styles, wherein the first format EDD def 
TareTmported from the first format EDD and the first format styles are created in the first format template to give 
^mentation text a first format look; and creating a first format source file comprising the 

with element tags, comprising importing the first format template into the second format source f.le the first format tern 
pll definitions 0 ; the first format template overriding the element definitions of the second format source file, and the 
documentation text conforming to the first format template definitions of the first format template. 
[0009] The invention may also comprise a method for creating online documentation from a print sour* file com- 
prising documentation text tagged with element tags, and element definitions, the print source file conforming to print 
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EDD definitions corresponding to a print EDD, the method comprising: creating an online EDD comprising online EDD 
definitions by deriving the online EDD definitions from the print EDD definitions, and modifying the online EDD defini- 
tions to comprise online formatting definitions; creating an online template comprising online template definitions, the 
online template definitions comprising online EDD definitions and online styles, wherein the online EDD definitions are 

5 imported from the online EDD, and the online styles are created in the online template to give the documentation text 
an online look; and creating an online source file comprising the documentation text tagged with the element tags, com- 
prising importing the online template into the print source file, the online template definitions of the online template over- 
riding the element definitions of the print source file, and the documentation text conforming to the online template 
definitions of the online template. 

10 [0010] The invention may also comprise a system for creating documentation in a first format from a source file in 
a second format, comprising a second format EDD comprising second format EDD definitions, the second format EDD 
definitions comprising second format formatting definitions; a second format source file comprising documentation text 
tagged with element tags, and element definitions, the documentation text conforming to second format EDD definitions 
corresponding to the second format EDD; a first format EDD comprising first format EDD definitions, wherein the first 

15 format EDD definitions are derived from the second format EDD definitions, and the first format EDD definitions com- 
prise first format formatting definitions; a first format template comprising first format template definitions, the first format 
template definitions comprising first format EDD definitions and first format styles, wherein the first format EDD defini- 
tions are imported from the first format EDD, and the first format styles are created in the first format template to give 
the documentation text a first format look; and a first format source file comprising the documentation text tagged with 

20 the element tags, wherein the first format source file is created by importing the first format template into the second 
format source file, the first format template definitions of the first format template overriding the element definitions of 
the second format source file, and the documentation text conforming to the first format template definitions of the first 
format template. 

[001 1] The invention may also comprise system for creating online documentation from a print source file, compris- 

25 ing a print EDD comprising print EDD definitions, the print EDD definitions comprising print formatting definitions; a print 
source file comprising documentation text tagged to element tags, and element definitions, the documentation text con- 
forming to print EDD definitions corresponding to the print EDD; an online EDD comprising online EDD definitions, 
wherein the online EDD definitions are derived from the print EDD definitions, and the online EDD definitions comprise 
online formatting definitions; an online template comprising online template definitions, the online template definitions 

30 comprising online EDD definitions and online styles, wherein the online EDD definitions are imported from the online 
EDD, and the online styles are created in the online template to give the documentation text an online look; and an 
online source file comprising the documentation text tagged to the element tags, wherein the online source file is cre- 
ated by importing the online template into the print source file, the online template definitions of the online template 
overriding the element definitions of the print source file, and the documentation text conforming to the online template 

35 definitions of the online template. 

[0012] The invention may also comprise a system for creating online documentation from a print source file, com- 
prising a print EDD embedded on a computer readable medium, wherein the print EDD comprises print EDD defini- 
tions, and the print EDD definitions comprise print formatting definitions; a print source file embedded on a computer 
readable medium, wherein the print source file comprises documentation text tagged with element tags, and element 

40 definitions, and the documentation text conforms to print EDD definitions corresponding to the print EDD; an online 
EDD embedded on a computer readable medium, wherein the online EDD comprises online EDD definitions, the online 
EDD definitions are derived from the print EDD definitions, and the online EDD definitions comprise online formatting 
definitions; an online template embedded on a computer readable medium, wherein the online template comprises 
online template definitions, and the online template definitions comprise online EDD definitions and online styles, 

45 wherein the online EDD definitions are imported from the online EDD; and the online styles are created in the online 
template to give the documentation text an online look; and an online source file embedded on a computer readable 
medium, wherein the online source file comprises the documentation text corresponding to element tags, and the online 
source file is created by importing the online template into the print source file such that the online template definitions 
of the online template override the element definitions of the print source file, and the documentation text conforms to 

so the online template definitions of the online template. 

[0013] The invention may also comprise a system for creating documentation in a first format from a source file in 
a second format, comprising means for creating a first format EDD comprising first format EDD definitions; means for 
creating a first format template comprising first format template definitions, wherein the first format template definitions 
comprise the first format EDD definitions; and means for creating a first format source file, wherein the first format 

55 source file comprises the first format template definitions. 
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Brief Description of the Drawings 

[0014] An illustrative and presently preferred embodiment of the invention is illustrated in the drawings in which: 
5 FIG. 1 illustrates a method for creating documentation in a first format from a source file in a second format. 

FIG. 2 illustrates a system for creating documentation in a first format from a source file in a second format. 
FIG. 3 illustrates components for creating a document in a prior art system. 

10 

FIG. 4 illustrates a preferred embodiment system for creating online documentation from a source file used for print 
documentation. 

Description of Preferred Embodiments 

15 

[001 5] FIG. 1 , in general, illustrates a method for creating documentation in a first format from a source file in a sec- 
ond format comprising creating first format element definition document (first format EDD) comprising first format EDD 
definitions 100; creating first format template comprising first format template definitions by importing first format EDD 
into template 102; and creating first format source file by importing first format template into second format source file 
20 104. 

[0016] FIG. 2, in general, illustrates a system for creating documentation in a first format from a source file in a sec- 
ond format comprising second format element definition document (second format EDD) 200 comprising second format 
EDD definitions 201 with second format formatting definitions 202; second format source file 21 1 comprising documen- 
tation text tagged with element tags 21 3, where the documentation text conforms to second format EDD definitions 201 ; 

25 first format element definition document (first format EDD) 203 comprising first format EDD definitions 204 derived from 
220 second format EDD definitions 201 of second format EDD 200, and first formatting definitions 206; first format tem- 
plate 207 comprising first format template definitions 208, comprising first format EDD definitions 204 imported from 
222 first format EDD 203, and first format styles 21 0; and first format source file 214 comprising documentation text 213 
conforming to first format template definitions 208, where the first format source file 214 is created 226 from importing 

30 224 first format template 207 into second format source file 21 1 . 

Introduction 

[0017] In a preferred embodiment, this invention is implemented using Adobe® FrameMaker+SGML™ (hereinafter 
35 FrameMaker+SGML™) which allows Standard Generalized Markup Language (SGML) documents to be created, 
edited, and published. SGML is an information management standard adopted by the International Organization for 
Standardization (ISO) as a means of providing platform- and application-independent documents that retain formatting, 
indexing, and linked information, thereby allowing an organization to share volumes of complex, frequently revised doc- 
uments across applications and computing platforms. SGML provides a grammarlike mechanism for users to define the 
40 structure of their documents and the tags they will use to denote the structure in individual documents. 

[0018] In order for a document to be fully portable as SGML, it should have an SGML Application associated with 
it. An SGML Application is a collection of files and information that fully describes how an SGML file is to be processed. 
In a preferred embodiment, as shown in FIG. 3, an SGML Application comprises DTD 300, element definition document 
(EDD) 304; and template 310. An SGML developer groups these files into an application and gives it a name. Once an 
45 SGML Application has been defined, a user document, or a source file 316 comprising documentation text 31 8 and ele- 
ment tags 320, can be created. 

Document Type Definition (DTD) 

50 [0019] DTD 300 is Document Type Definition document that allows users to define the structure of their documents 
in SGML. Typically, one DTD is created for each document type. For instance, a document type can be a Memo, Letter, 
Chapter, or Table of Contents. In a preferred embodiment of the invention, DocBook DTD version 3.0 is used to create 
documentation. 

[0020] DTD 300 comprises DTD element definitions 301 . An element definition 301 can comprise: 

55 

• Content rules that determine what the element can contain (text, nontext objects, or other elements) 

• Format rules that specify how the contents will be formatted 

• Attribute definitions that specify attributes for the element 
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[0021] In EXAMPLE 1, for instance, Note is an element in which elements GlossList, Itemized List, Ordered List, 
etc. can all be included (i.e., an ItemizedList element can follow a Note element), and in which Caution, Important, Note, 
Tip, and Warning cannot be included. Additionally, Note has attributes, such as Lang, such specifies that the element 
will be displayed in English. 

EXAMPLE 1: DTD 
[0022] 

< I ELEMENT Note - (Title?, (GlossList | Itemized List 

I OrderedList | SimpleList | VariableList I 

LiteralLayout I ProgramListing | Screen I 

ScreenShot | Synopsis CmdSynopsis | FuncSynopsis | 
Formal Para I 

Slide I Para I BlockQuote | 
Graphic I 

InformalEquation | 
InformalExample | Equation 
Example | Figure I 



InformalTable I Procedure I 

Sidebar I Anchor I BridgeHead 

I Comment) +) 

- (Caution, Important, 

Note, Tip, Warning) > 

< ! ATTLIST Note Id ID #IMPLIED 

Remap CDATA #IMPLIED 

Conditions CDATA #IMPLIED 

Lang (en) #IMPLIED > 



[0023] Since DTD 300 document is platform- and application-independent, it is a useful way to transmit documents 
to a variety of customers when the platform or application that the customers will use is an unknown factor: because 
DTD 300 document comprises standardized rules, it can be parsed (i.e., interpreted) by any machine. When DTD 300 
document is received by a customer, the customer can use an appropriate application to display the DTD document. 
For example, FrameMaker+SGML™ customers can use FrameMaker+SGML™ tools to convert an SGML document 
into a FrameMaker+SGML™ document (element definition document, or EDD 302, to be discussed) and perform addi- 
tional formatting, if desired. 

Element Definition Document (EDD) 



[0024] EDD 304 is an application-specific version of DTD 300 that comprises element definitions for displaying text. 
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Definitions for all elements valid in a particular EDD are defined in EDD definitions 306, which comprise DTD element 
definitions written in EDD syntax 307, and formatting definitions 308 also written in EDD syntax. EDD syntax is dictated 
by its underlying application, which a preferred embodiment, is FrameMaker+SGML™. EXAMPLE 2 illustrates some of 
the differences between EDD 304 and corresponding DTD 300: 



55 
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EXAMPLE 2: EDD 
[0025] 

[Element: (Container) : Note 

[[General Rule: Title?, (GlossList | Itemized List I 
OrderedList ISimpleList | VariableList 
ILiteralLayout | ProgramListing | Screen I 
ScreenShot | Synopsis I CmdSynopsis I 
FuncSynopsis I FormalPara I Slide I Para I 
BlockQuote | Graphic I Inf ormalEquation ) 
InformalExample | Equation I Example I Figure 
I Inf ormalTable I Procedure I Sidebar I Anchor | 
BridgeHead | Comment) +) 

[Exclusions: Caution, Important, Note, Tip, Warning 

[Attribute List 

1. [[Name: Id Unique ID J [Optional ]] 

2. [[Name: Remap ] [String ][ Optional ] 
[Control flags: [Hidden]]] 

3. [[Name: Conditions ] [Strings ] [Optional ]] 
4 . [ [Name : Lang ] [ Choice ] [ Optional ] 

[Choices : en] ] ] 
[Automatic insertions 

[Automatically insert child: Para]] 
[Text format rules] 

[[In all contexts. 

[ [ [Basic properties 
[ [ [ [Indents 

[[[[[Move first indent by: 0.0" 
[[[[[Move left indent by: 0.0" 
[Format rules for first paragraph in element] 
[[In all contexts. 

[ [ [Basic properties 
[[[[Indents 

[[[[[First Indent: 0.0" 
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[[[[[Left indent: 1.33333" 
[[[[Tab Stops 

[[[[[Tab stop position: 1.33333" 
[[[[[[Alignment: Left 
[[[[[[Leader: 
[ [ [ [Pagination properties 

[ [ [ [ [Widow/orphan lines : 3 
[[[[[Placement: Across all columns 

and side heads 
[ [ [ [ [Numbering properties 
[ [ [ [ [Autonumber format : N0TE\t 
[[[[[Character format: NCWTitle 
[ [ [ [Advanced properties 

[[[[[Frame above element: NCWTopLine 
[Format rules for last paragraph in element] 
[ [In all contexts . ] 

[ [ [Basic properties 
[[[[Indents 

[[[[[Move first indent by: 1.33333" 
[[[[[Move left indent by: 1.33333" 
[ [ [ [Pagination properties 

[ [ [ [ [Widow/orphan lines : 3 
[ [ ( [ [Placement: Across all columns 
and side heads Advanced 
properties 
[[[[[Frame below element: 
NCWBottomLine 



[0026] Notice that the General Rule, Exclusions, and Attribute List are DTD element definitions 301 written in EDD 
syntax 307. The remaining text (i.e. text following [Automatic insertions]) describes formatting definitions 308 for format- 
ting the Note element in different contexts (additional element definitions), where a context can be an entire document, 
a first numbered item, or a before a particular element, for example. For example, the Note element in EXAMPLE 2 
comprises three different formatting definitions in the form of rules: a text formatting rule, which applies in all contexts; 
a first paragraph formatting rule, which applies in all contexts, and a last paragraph formatting rule, which applies in all 
contexts. 
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Template 

[0027] Template 310 is a document that can be used as a foundation for creating or updating other documents. 
Templates 310 ensure that structure and style are consistent from one document to another Template 310 comprises 

5 template definitions 312 that are needed in more than one document. Template definitions 312 comprise EDD defini- 
tions 306 and template styles 314. Template styles 314 can include paragraph, character, and table formats, page lay- 
outs, and graphics and formatting information. Templates 310 can also have variable definitions, cross-reference 
formats, conditional text settings, color definitions, and equation size and font settings. Templates 310 are structured so 
that a source file 316 associated with template 310 will have the appearance of template 310. 

w [0028] EDD definitions 306 in template definitions 312 are imported from corresponding EDD 304. Styles 314 are 
defined in template 310 itself. EDD definitions 304 and styles 314 are compiled in template's Element Catalog, which 
comprise valid elements and corresponding element definitions. 

Source File 

15 

[0029] Source file 316 is a document comprising documentation text 318 (i.e., text to be displayed, published, or 
otherwise used by someone like an end user) that conforms to template definitions 312. Documentation text 318 is 
tagged to element tags 320 that correspond to elements in EDD definitions 306, and that identify which element defini- 
tion to reference in EDD definitions 306. Source file 316 is created by importing template 310 into a new document. 
20 Source file 316, like template 310, has an Element Catalog that comprises valid elements that can be used in source 
file 316, and corresponding element definitions. 

[0030] When template 310 is imported into a new document, the new document inherits EDD definitions 306 and 
template styles 314 from template 310 which can be used to format text typed into the document. When template 310 
is imported into an existing document (i.e., source file 316 comprising existing element definitions, which can include 
25 EDD definitions 306 and template styles 314, if any), previous element definitions are overridden by EDD definitions 
306 and template styles 31 4 of template 31 0. In both cases, the document or source file 31 6 becomes a replica of tem- 
plate 310. If template 310 is subsequently modified, document or source file 316 can re-import template 310 to inherit 
new template definitions 312. When template 310 is used, documentation text 318 in source file 316 conforms to tem- 
plate 310 in source file 316 to obtain overall look of template 310. 

30 

Creating Online Documentation from a Print Source File 

[0031] In a preferred embodiment, online documentation is created from an existing print source file, It should be 
understood, however, that concepts discussed herein are equally applicable to creating print documentation from an 
35 existing online source file, as well as for creating documentation in any first format from an existing source file in any 
second format. 

[0032] As shown in FIG. 4, print source file 420 is a document that comprises documentation text 422, or text to be 
used by an end user, tagged to element tags 424, wherein documentation text 422 conforms to print template 
definitions 414 of print template 412. Print template definitions 414 comprise print EDD definitions 406 and print styles 

40 41 8, both of which can be associated with documentation text 422. 

[0033] Since Frame Make r+SG ML™ is used in a preferred embodiment, print source file 420 originates from DTD 
400 comprising DTD element definitions 402 in a preferred embodiment. Print EDD 404 is created, comprising print 
EDD definitions 406. Print EDD definitions 406 comprise DTD element definitions written in EDD syntax 408 and print 
formatting definitions 410. Print template 412 can then be created. If print template 412 is used, print template 412 is 

45 imported into a new document to give resulting print source file 420 all of the element definitions and styles that are 
needed to create documentation text appropriate for a hard copy of the documentation, i.e., for a "print look". If print 
template 412 is not used, print EDD 404 is imported into a new document to give resulting print source file 420 all of the 
element definitions that are needed to create documentation text appropriate for a hard copy of the documentation, i.e., 
for a "print look". 

so [0034] All this information (i.e., element definitions and print styles, if any) is stored in print source file's 420 Element 
Catalog. While print EDD definitions 406 comprise definitions that can apply to a variety of documents, print styles 418 
comprise definitions that are specific to a print template 412 to give documentation text 422 a "print look". Documenta- 
tion text 422 can then be entered in print source file 420 and tagged with element tags 424 by entering text and asso- 
ciating the text with elements in the Element Catalog. 

55 [0035] To create documentation text 422 in print source file 420, element tag 424 can be pre-selected from print 
source file's 420 Element Catalog, and text 422 can be typed into print source file 420. Documentation text 422 can also 
be created by typing in the desired text 422, and then wrapping text 422 in a selected element tag 424 by selecting text 
422, and then selecting appropriate element tag 424. EXAMPLE 3 illustrates documentation text and corresponding 
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element tags (Head, Para, List, List Item) that are selected from an Element Catalog. 
EXAMPLE 3 : 
5 [0036] 



TEXT 


ELEMENT TAG 


Tools and Materials Required 


Head 


Make sure that you have the following tools ad materials before beginning any maintenance 
tasks on the light rail trains: 


Para 


• Flat-head screwdrivers 


List item 


• Approved lubricants 


List List item 


• Pressure gauge 


List item 



20 [0037] Thus, when typing the text "Tools and Materials Required", a user could type in the text, select the text, and 
go to the Element Catalog to select the element tag Head. Text is automatically formatted and structured according to 
how element Head is defined in print template definitions 414. 

[0038] When a user next types in the paragraph starting with "Make sure..." under element Head, print source file's 
420 Element Catalog displays a list of all available elements according to print template definitions 414. That is, the Ele- 
25 ment Catalog displays those elements that can follow a Head element, as defined in print EDD definitions 406 of print 
template definitions 414. In EXAMPLE 3, Para could be a valid element under Head. An element definition for Head 
(which is defined in print EDD definitions 406) could be defined as follows: 

[Element (Container): Head 

30 

[[General Rule: Title?, (Para | Comment)+)]] 

[0039] The text following the Para element could be created if a user selected the List element from the Element 
Catalog. In EXAMPLE 3, the List element contains element Listltem so that when element List is selected, Listltem is 
35 automatically inserted. Again, this rule is defined in print EDD definitions 406, and could be defined as follows: 

[Element (Container): List 



40 

[Automatic insertions 

[Automatically insert child: List item]] 

45 [0040] Once all documentation text 422 is typed into print source file 420, a document which conforms to print tem- 
plate definitions 414 exists. When print source file 420 is printed out, printed documentation has appearance appropri- 
ate for a hard copy of the documentation. 

[0041] With the increasing use of computers, and particularly network services, such as the Internet, users are 
becoming more accustomed to online formats. Therefore, rather than hard copy documentation, many users require 

so online documentation. This invention utilizes existing files for print documentation to create online documentation com- 
prising the same substance as the print documentation but in a format suitable for online viewing rather than a hard 
copy of the documentation. As shown in FIG. 2, online element definition document (online EDD) 426 is derived from 
444 an existing print element definition document (print EDD) 404 (FIG. 1 , 100). Online template 434 is created (FIG. 
1 , 1 02) by importing 212 from online EDD 426. Online template 434 is then imported 446 (FIG. 1 , 1 04) to print source 

55 file 420 to create 448 online source file 442. 
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Creating an Online Element Definition Document 

[0042] As shown in FIG. 4, online EDD 426 is derived 444 from print EDD 404. This can be accomplished, for exam- 
ple, by copying print EDD 404 or directly modifying print EDD 404 and then renaming it. When online EDD 426 is 
derived from print EDD 404, online EDD 426 comprises print EDD definitions 406. Online formatting definitions 432 are 
then added to online EDD 426. Together, print EDD definitions 406 and online formatting definitions 432 comprise 
online EDD definitions 428. For example, EXAMPLE 4 illustrates how an element, Note, is defined in print EDD defini- 
tions 406, and how the same element is defined in online EDD definitions 428 using online formatting definitions: 



[Element (Container) : Note 

[[General Rule: Title?, (GlossList | Itemized List | 
OrderedList ISimpleList | VariableList 
ILiteralLayout I ProgramLi sting | Screen | 
ScreenShot | Synopsis | CmdSynopsis I 
FuncSynopsis IFormalPara | Slide I Para | 
BlockQuote (Graphic | Inf ormal Equation I 
InformalExample | Equation | Example | Figure 
I Inf ormalTable I Procedure I Sidebar I Anchor | 
BridgeHead I Comment) +) 

[Exclusions: Caution, Important, Note, Tip, Warning 

[Attribute List 



EXAMPLE 4 : 



[0043] 



Print EDD Definitions 



1. 



[[Name: Id Unique ID ] [Optional ]] 

[[Name: Remap ] [String ][ Optional ] 

[Control flags : [Hidden] ] ] 

[[Name: Conditions ] [Strings ] [Optional ]] 



2. 



3. 



4. 



[ [Name : Lang ] [ 
[Choices : en] ] ] 



Choice ] [ Optional ] 



[Automatic insertions 



[Automatically insert child: Para]] 
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[Text format rules] 

[[In all contexts. 

[ [ [Basic properties 
[[[[Indents 

[[[[[Move first indent by: 0.0" 
[[[[[Move left indent by: 0.0" 
[Format rules for first paragraph in element] 
[[In all contexts. 

[ [ [Basic properties 
[[[[Indents 

[[[[[First Indent: 0.0" 
[[[[[Left indent: 1.33333" 
[ [ [ [Tab Stops 

[[[[[Tab stop position: 1.33333" 
[[[[[[Alignment: Left 
[[[[[[Leader: 
[ [ [ [Pagination properties 

[[[[[Widow/orphan lines: 3 
[[[[[Placement: Across all columns 

and side heads 
[ [ [ [ [Numbering properties 
[ [ [ [ [Autonumber format: N0TE\t 
[[[[[Character format: NCWTitle 
[ [ [ [Advanced properties 

[[[[[Frame above element: NCWTopLine 
[Format rules for last paragraph in element] 
[ [In all contexts . ] 

[ [ [Basic properties 
[[[[Indents 

[[[[[Move first indent by: 1.33333" 
[[[[[Move left indent by: 1.33333" 
[ [ [ [Pagination properties 
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[[[[[Widow/orphan lines: 3 

tt [[[Placement: Across all columns 

and side heads Advanced 

properties 
[[[[[Frame below element: 

NCWBottomLine 



Online EDD Definitions 
[Element (Container) : Note 

[[General Rule: Title?, (GlossList I Itemized List | 
OrderedList ISimpleList | VariableList 
iLiteralLayout I ProgramListing I Screen I 
ScreenShot | Synopsis | CmdSynopsis | 
FuncSynopsis IFormalPara I Slide I Para I 
BlockQuote (Graphic I Inf ormalEguation I 
Inf ormalExample I Equation | Example I Figure 
I InformalTable I Procedure I Sidebar I Anchor I 
BridgeHead I Comment) +) 

[Exclusions: Caution, Important, Note, Tip, Warning 

[Attribute List 

1. [[Name: Id Unique ID ] [Optional ]] 

2. [[Name: Remap ] [String ][ Optional ] 
[Control flags: [Hidden]]] 

3. [[Name: Conditions ] [Strings ] [Optional ]] 
4 . [ [Name : Lang ] [ Choice ] [ Optional ] 

[Choices: en]]] 
[Automatic insertions 

[Automatically insert child: Para]] 
[Text format rules] 

[[In all contexts. 

[Use paragraph format:: Note Indented 
[Format rules for first paragraph in element] 
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[[In all contexts. 

[Use paragraph format: Notelndented 
[Format rules for last paragraph in element] 
[ [In all contexts . ] 

[Use paragraph format: Notelndented 



[0044] Whereas print EDD definitions 406 for element Note comprise specific formatting for the print documentation 
(i.e., paragraph indents and tab stops), online EDD definitions 428 in this example refer to a format I.D., where the for- 
mat' defines formatting settings such as those explicitly set out in print EDD definitions 406. The format is defined in 
online template definitions 436 of online template 434. 



Creating an Online Template 

[0045] Online template 434 comprising online template definitions 436 is created by importing online EDD defini- 
tions 428 from online EDD 426 and adding online styles 440 to online template 434. While online EDD definitions 428 
comprise definitions that can apply to a variety of documents, online styles 440 comprise definitions that are specific to 
an online template 412 to give documentation text 422 an "online look". Online styles 440 include: 

• Paragraph formats, or a collection of properties that apply to an entire paragraph, including the default font, any tab 
settings, and spacing above and below the paragraph. 

• Character formats, or a collection of font settings that apply to a range of text. 

• Table formats to define the appearance of tables. 

• Page layouts that determine the number of columns on a page and their positions. The page layouts also contain 
the text and graphics that appear in the background on body pages. 

• Reference pages for holding common graphics and formatting information. 

• Cross-reference formats that determine the text and appearance of cross-references. 

• Variable definitions that let allow placeholders to be used for text that FrameMaker+SGML™ can update as the def- 
initions change. 

• Condition tags and conditional text settings that manage different versions of a single document in the same file. 

• Colors specific to a document. There is a default, basic set of colors, but a template can include custom colors. 

• Math definitions that include equation size, font settings, and custom math element definitions. 

[0046] In a preferred embodiment, paragraph formats are the primary way of adding online style 440 to online tem- 
plate 434. For example, paragraph format Notelndented, supra is defined in online template definitions 436 so that 
FrameMaker+SGML™ can refer to this format when the paragraph format Notelndented is encountered in online EDD 
426. Formats can be referenced by any number of elements. EXAMPLE 5 illustrates how paragraph format Note- 
Indented can be defined in online template 434 to add online style 440: 



EXAMPLE 5: Online Style 



Notelndented 



[0047] 

Para Alignment Center 

Left Indent 36.0 pt 

Right Indent 0.0 pt 

Frame Above Para (None) 

Frame Below Para (None) 

Para Start At Anywhere 

Para Placement Normal 
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Space Above 0.0 pt 

Space Below 4.0 pt 

Keep With Previous No 



5 



Keep With Next No 
Widow-Orphan Lines 3 
Font Family GillSans 
Font Variation Regular 



15 



10 



Font Weight Bold 

Font Angle Italic 

Font Size 9.0 pt 

Font Spread 0.0% 

Font Color Black 

Line Spacing Fixed 

Tab Stops 36.0 pt 

Tab Type Left 



Tab Leader (Space) 
Hyphenation No 



Hyph Language USEnglish 

20 Creating an Online Source File 

[0048] Once online EDD 426 and online template 434 are created, online source file 442 can be created by import- 
ing 446 online template 434 into print source file 420. When a template is imported into a source file as opposed to a 
new document, template definitions override any and all previous definitions in the source file. The importance of 

25 importing online template 434 into print source file 420, as is done in this invention, is that online source file 442 does 
not have to be created from scratch. Creating online source file 442 from scratch entails recreating documentation text 
422 (i.e., the text to be read by end users), and tagging individual pieces of documentation text 442 with element tags 
424 from online template definitions 436 in online template 434 such that documentation text 422 conforms to an online 
appearance defined by online template 434. 

30 [0049] Thus, when online template 434 is imported 446 into print source file 420, online template definitions 436 
replace print template definitions 414 that were previously incorporated into print source file 420. Once online template 
434 is imported into print source file 420, online source file 442 is created 448. Since print source file 420 can be rec- 
reated simply by importing print template 412 into online source file 442 that is created from importing online template 
434 into print source file 420, online template 434 can be directly imported into print source file 420 without conse- 

35 quence. However, it is also possible to create a copy of print source file 420, and to import online template 434 into the 
copy of print source file 420. Therefore, while online source file 442, 442 is depicted as an object different from print 
source file 420, 420 (as would be the case if online template 434 is imported into a copy of print source file 420), the 
depiction should be understood as merely illustrating the transformation of print source file 420, 420 to online source 
file 442, 442. 

40 [0050] When online template 434 is imported into print source file 420, documentation text 422 is formatted accord- 
ing to online template definitions 436. For example assume that documentation text "This is a title" is tagged with ele- 
ment Title and is the first paragraph of element Title; "This is a first para note" and "This is a last para note" are tagged 
with element Note, where "This is a first para note" is the first paragraph of element Note, and This is a last para note" 
is a last paragraph of element Note. Also assume that Note is a valid child of Title. When original print source file 420 

45 was created, documentation text 422 in print source file 420 conformed to print template definitions 414. For example, 
if print template definitions 414 comprised print EDD definitions 410 of EXAMPLE 5, supra, and if both Note and Title 
comprise the same first and last paragraph formatting, documentation text in print source file 420 would have the 
appearance shown in EXAMPLE 6: 

so EXAMPLE 6: PRINT SOURCE FILE - Documentation Text 



[0051] 



PRINT SOURCE FILE 



ELEMENT TAG 



55 
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10 



'thisis a title. 



This is a note first para note. 
This is a last para note. 



Title 



Note 



15 



20 



r00521 Notice that the first paragraph of element Title ("THIS IS A TITLE") is formatted in accordance with print EDD 
Son 4?0 a para raph?n that it is not indented, and that both the first and J^£»^^ 
Note ("This is a first para note.", and "This is a last para note.") are formatted accord,ng to pnnt EDD def.nrt.on for a f .rst 

online EDD deW^^ 

that the following font is Gi.lSans, the font specified for paragraph format Note.ndented '" EXAMPLE 5 ( Font Fam.ly ), 
documentation text 422 in online source file 442 could have the appearance shown .n EXAMPLE 7. 

EXAMPLE 7; ONLINE SOURCE FILE - Documentation Text 



25 



30 



[0054] 



ONLINE SOURCE FILE 



35 



This is a Title. 

This is a first para note. 
This is a lest para note. 



ELEMENT TAG 

Title 

Note 



40 



fOOSSl When FrameMaker + SGML™ encounters element tags 424 in online source file 442, Element Catalog i corre- 
[0055] wner mame refe renced for online EDD definitions 428. Since element Title (corresponds to 

£3£ I SUISSE: Paragraph format Note.ndented (see online EDD definifio^ 428 
45 o TEMPLE Ts"^). format Notelndented is referenced in online source file 442 for 'nstruct,ons on hovv r o format 
"This is a trtle " When element Note is found, FrameMaker + SGML™ also refers to paragraph format Notelndented and 
Z^Ji oarLraoh (This is a first para note.") according to the definition set forth for a first paragraph of ele- 

50 mm ° f teTulg online source file 442 comprises documentation text 422 and element tags 424 matching dccu- 
Stion tert 422 and Element tags 424 of print source file 420. Online source file 442 differs from pnnt source We 420 
^S^^^conJ^ to dement tags 424 and documentation text 422. Print source Me «0com- 
prits d<xuIltion text 422 that conforms to print template definitions 414 of print template 412, whereirr docurnen- 
tetton tSt 422 of online source file 442 conforms to online template definitions 436 of onhne template 434. In short 

55 ole source file ,Zz comprises documentation text 422 that is substantively the same as documentat.cn text 422 from 

of online source file 442 has the appearance of online documentation. u .i««.Qrui tm online source 

[0057] Since intended users of online source file 442 may not have access to FrameMaker + SGML™. online source 
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file 442 can be converted into a portable document format, or one which a wide range of users can read. In a preferred 
embodiment, online source file 442 is converted into an Adobe® PDF file, using Adobe Distiller. A PDF file allows any- 
one with Adobe Acrobat Reader to view, navigate, and print documents that are in the Adobe Portable Document For- 
mat. Since Adobe Acrobat Reader is freeware, and can be obtained by any user, and because the format can be viewed 
5 on different platforms, converting online source file 442 to PDF makes online documentation available to a wider range 
of users. 

Conclusion 

w [0058] Defining styles in the online template allows the appearance of a document to change without having to 
make detailed and lengthy changes to an EDD. Since documentation text 422 and element tags 424 in both print source 
fife 420 and online source file 442 are the same, the time and expense otherwise needed to type documentation text 
422 and manually format different parts of the documentation are eliminated. Because the only difference between print 
source file 420 and online source file 442 are the styles 418, 440, which are quick and easy to implement, and format- 

15 ting definitions 410, 432 which are, for the most part, derived from existing definitions, the conversion from print docu- 
mentation to online documentation (and from online documentation to print documentation) is simple and inexpensive. 
Furthermore, this invention allows a certain "look", or style, to be reused by a simple reference to the format name, elim- 
inating the onerous task of having to redefine format settings for each element that wants to use a certain style. 
[0059] Without the use of this method for creating online documentation, an online document would otherwise have 

20 to be created by making extensive formatting changes to a print EDD, as well as manually creating an online template 
and an online source file. For instance, to modify element Note such that it has the appearance of format Note Indented, 
for example, where format Notelndented has an online look, an EDD developer would have to go into the print EDD (or 
a copy thereof), and individually define desired format settings for element Note. This could include modifying defini- 
tions for Tab Stops and Indents such that those settings match those of format Notelndented. An online template would 

25 have to be created and imported into an online source file. Text would have to be manually entered into the online 
source file, and individual pieces of the text would have to be manually formatted by selecting desired element tags. 
[0060] Furthermore, if another element, such as Title, had a use for the same look as that defined for element Note, 
the same format settings would have to be defined for element Title as element Note. Again, this would entail an EDD 
developer having to go into the print EDD (or a copy thereof), and individually define desired format settings for element 

30 Title, which could include modifying definitions for Tab Stops and Indents such that the settings match those of format 
Notelndented. 

[0061] A preferred embodiment of the invention described herein has been directed to a method and system for 
creating online documentation from the same source file used for print documentation, It should be understood, how- 
ever, that it is also within the scope of this invention that the method and system apply to creating print documentation 

35 from the same source file used for online documentation, and that the invention, in general, encompasses the conver- 
sion of documentation in one format to documentation in a second format. Furthermore, although a preferred embodi- 
ment of the invention utilizes an SGML DTD as a starting point, it should be understood that an SGML DTD is used in 
a preferred embodiment of using FrameMaker+SGML™, and is not a necessary starting point for the invention. 
[0062] While the invention has been described in a FrameMaker+SGML™ context, it should be understood that this 

40 invention is applicable to any document formatter having similar characteristics as FrameMaker+SGML™. Such char- 
acteristics include text that is tagged with definitions that are defined external to the document comprising documenta- 
tion text, and documents comprising formatting definitions for text. 

[0063] While illustrative and presently preferred embodiments of the invention have been described in detail herein, 
it is to be understood that the inventive concepts may be otherwise variously embodied and employed, and that the 
45 appended claims are intended to be construed to include such variations, except as limited by the prior art. 

Claims 

1 . A method for creating documentation in a first format from a source file in a second format, wherein said source file 
so comprises documentation text tagged with element tags, and element definitions, said source file conforming to 
second format EDD definitions corresponding to a second format EDD, said method comprising: 

a. creating a first format EDD comprising first format EDD definitions by deriving said first format EDD defini- 
tions from said second format EDD definitions, and modifying said first format EDD definitions to comprise first 

55 format formatting definitions ( 1 00); 

b. creating a first format template comprising first format template definitions, said first format template defini- 
tions comprising first format EDD definitions and first format styles (102), wherein: 
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i. said first format EDD definitions are imported from said first format EDD; and 

ii. said first format styles are created in said first format template to give said documentation text a first for- 
mat look; and 

5 c. creating a first format source file comprising said documentation text tagged with element tags, comprising 

importing said first format template into said second format source file, said first format template definitions of 
said first format template overriding said element definitions of said second format source file, and said docu- 
mentation text conforming to said first format template definitions of said first format template (104). 

10 2. A method as in claim 1 , wherein said modifying said first format EDD definitions to comprise first format formatting 
definitions comprises referencing said first format styles in said first format template. 

3. A method as in claim 1 , wherein said adding first format styles comprises creating paragraph formats for formatting 
documentation text to have a first format look. 

15 

4. A method for creating online documentation from a print source file comprising documentation text tagged with ele- 
ment tags, and element definitions, said print source file conforming to print EDD definitions corresponding to a 
print EDD, said method comprising: 

20 a. creating an online EDD comprising online EDD definitions by deriving said online EDD definitions from said 

print EDD definitions, and modifying said online EDD definitions to comprise online formatting definitions; 

b. creating an online template comprising online template definitions, said online template definitions compris- 
ing online EDD definitions and online styles, wherein: 

25 i. said online EDD definitions are imported from said online EDD; and 

ii. said online styles are created in said online template to give said documentation text an online look; and 

c. creating an online source file comprising said documentation text tagged with element tags, comprising 
importing said online template into said print source file, said online template definitions of said online template 

30 overriding said element definitions of said print source file, and said documentation text conforming to said 

online template definitions of said online template. 

5. A method as in claim 4, wherein said modifying said online EDD definitions to comprise online formatting definitions 
comprises referencing said online styles in said online template. 

35 

6. A method as in claim 4, wherein said adding online styles comprises creating paragraph formats for formatting doc- 
umentation text to have an online look. 

7. A method as in claim 6, wherein said modifying said online EDD definitions to comprise online formatting definitions 
40 comprises referencing said paragraph formats in said online template. 

8. A system for creating documentation in a first format from a source file in a second format, comprising: 

a. a second format EDD (200) comprising second format EDD definitions (201), said second format EDD def- 
45 initions comprising second format formatting definitions (202); 

b. a second format source file (211) comprising documentation text tagged with element tags (213), and ele- 
ment definitions, said documentation text conforming to second format EDD definitions corresponding to said 
second format EDD; 

c. a first format EDD (203) comprising first format EDD definitions (204), wherein said first format EDD defini- 
50 tions are derived from (220) said second format EDD definitions, and said first format EDD definitions comprise 

first format formatting definitions (206); 

d. a first format template (207) comprising first format template definitions (208), said first format template def- 
initions comprising first format EDD definitions and first format styles (210), wherein: 

55 i. said first format EDD definitions are imported from (222) said first format EDD; and 

ii. said first format styles are created in said first format template to give said documentation text a first for- 
mat look; and 
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e. a first format source file (214) comprising said documentation text tagged with element tags, wherein said 
first format source file is created (226) by importing (224) said first format template into said second format 
source file, said first format template definitions of said first format template overriding said element definitions 
of said second format source file, and said documentation text conforming to said first format template defini- 
tions of said first format template. 

9. A system for creating online documentation from a print source file, comprising: 

a. a print EDD comprising print EDD definitions, said print EDD definitions comprising print formatting defini- 
tions; 

b. a print source file comprising documentation text tagged with element tags, and element definitions, said 
documentation text conforming to print EDD definitions corresponding to said print EDD; 

c. an online EDD comprising online EDD definitions, wherein said online EDD definitions are derived from said 
print EDD definitions, and said online EDD definitions comprise online formatting definitions; 

d. an online template comprising online template definitions, said online template definitions comprising online 
EDD definitions and online styles, wherein: 

i. said online EDD definitions are imported from said online EDD; and 

ii. said online styles are created in said online template to give said documentation text an online look; and 

e. an online source file comprising said documentation text corresponding to element tags, wherein said online 
source file is created by importing said online template into said print source file, said online template defini- 
tions of said online template overriding said element definitions of said print source file, and said documenta- 
tion text conforming to said online template definitions of said online template. 

10. A system as in claim 9, wherein online formatting definitions comprise references to said online styles in said online 
template. 
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